home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Special 25 / AMIGAplus Sonderheft 25 (2000)(Falke)(DE)(Track 1 of 4)[!].iso / Updates / PowerPC / pdflib / readme.txt < prev    next >
Text File  |  2000-05-16  |  8KB  |  245 lines
  1. PDFlib V2.01
  2. ============
  3. Portable C library for dynamically generating PDF ("Adobe Acrobat") files.
  4. Copyright (c) 1997-1999 Thomas Merz (tm@muc.de)
  5.  
  6. The PDFlib distribution is available from the following URL:
  7. http://www.ifconnection.de/~tm
  8.  
  9. THIS IS NOT PUBLIC DOMAIN OR FREEWARE SOFTWARE -- 
  10. see end of this file for an overview of licensing and
  11. usage issues, and the file doc/license.pdf for details.
  12.  
  13.  
  14. Overview
  15. ========
  16. PDFlib is a C library for generating PDF files. It offers a graphics
  17. API with support for drawing, text, fonts, images, and hypertext. Call PDFlib
  18. routines from within your client program and voila: dynamic PDF files!
  19. For detailed instructions on PDFlib programming and the associated API,
  20. see the PDFlib Programming Manual, included in PDF format in the
  21. PDFlib distribution.
  22.  
  23.  
  24. Supported Programming Environments
  25. ==================================
  26. The PDFlib core library can be built as a static library or a shared
  27. C library/DLL. PDFlib can be used from the following environments:
  28.  
  29. - ANSI C libary (static or dynamic)
  30. - ANSI C++ via an object wrapper
  31. - Perl5  with help from SWIG
  32. - Tcl with help from SWIG
  33. - Python with help from SWIG
  34. - Java via the JNI with help from a hacked SWIG version
  35. - Visual Basic with a DLL and a type library
  36.  
  37. - PHP3: PDFlib support is already included in the PHP3 distribution,
  38.   see http://www.php.net. Note that PHP3 is not directly supported by
  39.   the author of PDFlib.
  40.  
  41. The necessary "glue" for attaching PDFlib to these environments is
  42. included in the distribution, as well as sample programs for all
  43. supported environments.
  44.  
  45. Two sample applications are supplied for all supported language bindings:
  46.  
  47. - hello:    simple "hello, world!" program
  48. - pdfclock:    generate a PDF file with an analog clock image
  49.  
  50.  
  51. PDF Features
  52. ============
  53. PDFlib's many features are covered in detail in the programming manual.
  54. So let's just take a brief look at the most important ones:
  55.  
  56. - basic drawing
  57.   lines, rectangles, arcs, Bezier curves, ...
  58.   gray scale or RGB color
  59. - text
  60.   text in different fonts and sizes, formatting
  61.   type 1 font embedding, built-in font metrics, AFM metrics files for 
  62.   additional fonts
  63. - image file formats
  64.   support for CCITT, TIFF, GIF, and JPEG files
  65. - PDF output compression via Zlib
  66. - hypertext features
  67.   bookmarks, page transitions, Web and local links, PDF file attachments
  68. - Unicode support for annotations, bookmarks, and document information
  69.  
  70.  
  71. PDFlib application ideas
  72. ========================
  73. - Dynamic PDF generation on a Web server
  74. - Directly convert text or graphics files to PDF
  75. - Report generator for applications such as databases
  76. - PDF-generating printer driver for all kinds of applications
  77. - ...many more!
  78.  
  79.  
  80. Supplied Library Clients
  81. ========================
  82. PDFlib includes some test and real client programs:
  83.  
  84. - pdftest:    general C test program, illustrates many PDF features
  85. - pdfimage:    convert GIF/TIFF/JPEG images to PDF
  86. - text2pdf:    convert text files to PDF
  87. - pdfgraph:    draw a graph according to data read from a text file
  88.  
  89.  
  90. Platform support
  91. ================
  92. PDFlib requires an ANSI C compiler and runs on many platforms since
  93. it doesn't make use of an platform-specific features, and doesn't
  94. have a user interface. PDFlib is primarily developed and tested
  95. on the following platforms:
  96.  
  97. - Linux 2.2.1 with GCC
  98. - Windows NT 4 with Microsoft Visual C++ 6.0
  99. - MacOS 8.6 with Metrowerks CodeWarrior Pro 4
  100.  
  101. In addition to these platforms, PDFlib has been compiled and tested on 
  102. many other flavors of Unix.
  103.  
  104.  
  105. Where to start?
  106. ===============
  107. PDFlib comes with a comprehensive manual which can be found as a
  108. PDF document in the doc directory.
  109.  
  110.  
  111. Building the library on Unix systems
  112. ====================================
  113. Building PDFlib on Unix basically requires the usual
  114.  
  115. ./configure
  116. make
  117. make test
  118. make install
  119.  
  120. sequence. More information on configure options can be found
  121. in the file doc/install.txt.
  122.  
  123. If your system doesn't offer getopt, you can use the supplied
  124. public domain getopt module instead. By default, this module
  125. is not used, so you will have to add it manually in the makefile.
  126. Note that the core library doesn't use getopt, only some sample clients.
  127.  
  128.  
  129. Building the library on Windows NT
  130. ===================================
  131. To compile PDFlib with MS Visual C++, open the supplied workspace
  132. file which contains several projects for the core library, test programs,
  133. and language bindings. Set "test" to be the active project, and build.
  134. Currently you will have to either copy the PDFlib DLL to the test
  135. directory in order to execute the pdftest program (which starts
  136. several threads for generating PDF), or seth your PATH appropriately.
  137.  
  138. A project file called pdflib_static may be used for building a
  139. static version of the PDFlib library.
  140.  
  141.  
  142. Building the library on the Mac
  143. ===============================
  144. To compile PDFlib with Metrowerks CodeWarrior, open the supplied
  145. project file PDFlib.mcp with the Metrowerks IDE. The pdftest target
  146. will build the pdftest program in the test folder. This console program
  147. can be used to test the library, and serve as a starting point for
  148. your own PDFlib-powered applications.
  149.  
  150.  
  151. Building the library on other platforms or with other compilers
  152. ===============================================================
  153. In order to build PDFlib with other compilers, you will have to write
  154. a suitable makefile or project file. Simply stuff all *.c and *.h
  155. files in the pdflib subdirectory into your project.
  156.  
  157. If you want to build a DLL for Windows NT, set the PDFLIB_EXPORTS
  158. define. In order to build a static library for PDFlib under Windows, set the 
  159. PDFLIB_STATIC define. Set neither of these defines for including the
  160. PDFlib header file in your application.
  161.  
  162.  
  163. External libraries used in PDFlib
  164. =================================
  165. PDFlib makes use of other libraries if they are available:
  166.  
  167. - Sam Leffler's TIFFlib if you want to read TIFFs with PDFlib
  168.   TIFFlib is available from ftp://ftp.sgi.com/graphics/tiff
  169.  
  170.   A Mac version of TIFFlib used to be available from
  171.   http://www.cwi.nl/~jack/macsoftware.html
  172.  
  173. - The zlib compression library for compressed PDF output
  174.   zlib is available from http://www.cdrom.com/pub/infozip/zlib
  175.  
  176.   A Windows DLL version of zlib used to be available from
  177.   http://www.winimage.com/zLibDll/
  178.  
  179.   A Mac version of ZLIB used to be available from
  180.   http://www.cwi.nl/~jack/macsoftware.html
  181.  
  182. Note that the use of these libraries on non-Unix platforms has not
  183. yet been tested, the above URLs are quoted for your convenience only.
  184. The Unix configure script will automatically find out which libraries
  185. are available. Note that certain builds of the TIFF library also need
  186. the JPEG library.
  187.  
  188. If the TIFFlib or zlib libraries are not available, PDFlib will
  189. work anyway, although (of course) it will be lacking the respective features.
  190.  
  191.  
  192. A Shameless Plug
  193. ================
  194.  
  195. My book has more information on PDFlib and PDF/Web integration.
  196. The book is currently available in English, German, and Japanese:
  197.  
  198. Mit Acrobat ins World Wide Web
  199. Effiziente Erstellung von PDF-Dateien und ihre Einbindung ins Web.
  200. Thomas Merz Verlag Muenchen, ISBN 3-9804943-1-4.
  201.  
  202. Web Publishing with Acrobat/PDF
  203. Springer-Verlag Heidelberg Berlin New York 1998, ISBN 3-540-63762-1
  204.  
  205. Japanese edition:
  206. Tokyo Denki Daigaku 1999, ISBN 4-501-53020-0
  207. See http://plaza4.mbn.or.jp/~unit
  208.  
  209.  
  210. Licensing and Copyright
  211. =======================
  212.  
  213. THIS IS NOT PUBLIC DOMAIN OR FREEWARE SOFTWARE!
  214.  
  215. This software is subject to the "ALADDIN FREE PUBLIC LICENSE". The
  216. complete text of the license agreement can be found in the file
  217. doc/license.pdf. In short and non-legal terms:
  218.  
  219. - You may develop and use software based on PDFlib without paying a fee
  220. - You may non-commercially re-distribute PDFlib without paying a fee,
  221.   provided you don't modify the package
  222. - Selling PDFlib-based products requires a commercial license. Please
  223.   contact the author for licensing details.
  224.  
  225. Note that this is only a 10-second-description which is not legally
  226. binding. Only the text in the license file is considered to completely
  227. describe the licensing conditions. In order to obtain a commercial
  228. license, please contact the author (see below).
  229.  
  230. If you use this software you need to honor the copyright notices.